home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / os2 / pmt111.zip / readme.txt < prev    next >
Text File  |  1996-10-31  |  9KB  |  192 lines
  1. ********************************************************
  2. *                                                     ***
  3. *   This is readme.txt for PM Timer version: 1.11     ***
  4. *                                                     ***
  5. *********************************************************
  6.  ********************************************************
  7.  
  8.  
  9. What is it?
  10. ===========
  11. PM Timer/2 is an online phone costs calculation program for OS/2 Presentation
  12. Manager. It gets rid of the hassle of having to use a different logfile for
  13. every communications program you use, not to mention the programs that don't
  14. even keep a logfile (think about Dial Other Internet Providers in the OS/2 Warp
  15. bonuspak).
  16.  
  17. PM Timer - when used in the right manner - logs all your outgoing calls in one
  18. single logfile and calculates the phone costs made in a specified period of
  19. time on your demand.
  20.  
  21. PM Timer will monitor the serial port to which your modem is connected and
  22. detect any connections you make with your modem.
  23.  
  24. Furthermore, if desired you can run PM Timer unattended from batchfiles using
  25. commandline parameters.
  26.  
  27. And, with PM Timer running you'll always keep track of your online (surfing)
  28. time, even if the PM Timer window is invisble. PM Timer places a small clock
  29. that displays the online time in the currently active Presentation Manager
  30. window's titlebar.
  31.  
  32.  
  33. Installation
  34. ============
  35. I recommend you to install PM Timer in its own directory. Installation is
  36. simply a matter of copying all the files from the PM Timer archive to an
  37. empty directory. In case you want to be able to start the program from other
  38. directories you have to make sure that the file IOPL.DLL is located in a
  39. directory in your LIBPATH statement in config.sys. Also make sure you have
  40. IOPL=YES in your config.sys.
  41.  
  42. NOTE: If you install PM Timer into the same directory as a previous version,
  43.       make sure you delete the pmtimer.ini if it exists.
  44.  
  45. The main idea is to start PM Timer together with your communications program
  46. from a batchfile (.CMD). That is the way I use it myself.
  47. You can also put PM Timer in your startup folder and let it startup minimized
  48. with the /h commandline parameter.
  49. personally I prefer the first method, because that way you can setup different
  50. startup parameters (i.e. local/non local call hide/not hide) for the different
  51. communication programs you use.
  52.  
  53. If you use the first method, simply create a batchfile in your communication
  54. program's directory that looks like this:
  55.  
  56. @ECHO OFF
  57. START X:\PATH\PMTIMER [/L /H]
  58. COMPROG.EXE
  59. X:\PATH\PMTIMER /Q
  60.  
  61. Where: * X:\PATH\ is the drive and directory where you keep PM Timer files.
  62.  
  63.        * COMPROG.EXE is the executable file which starts your communication
  64.          program.
  65.  
  66.        * /L commandline parameter (optional)
  67.          If specified, PM Timer will startup in Local mode. Meaning that the
  68.          costs for Local calls you specified in the settings notebook will be
  69.          used for calculations.
  70.          You can also change this 'on the fly' while PM Timer is running (and
  71.          not counting) by checking/unchecking the Local call checkbutton in
  72.          the main window.
  73.  
  74.        * /H commandline parameter (optional)
  75.          If specified, PM Timer will startup invisble. You can make it visible
  76.          by doubleclicking its entry in the window list.
  77.  
  78.        * /Q commandline parameter (optional)
  79.          Well, it's kind of optional. In the example above it is required.
  80.          If PM Timer is started with this option specified it will try and
  81.          find an already running copy of itself in memory and correctly
  82.          terminate it. (Same effect as choosing Close from the system menu
  83.          or hitting ALT-F4.)
  84.  
  85.        * Parameters are case-insensitive and can be stacked on the commandline.
  86.          (e.g. You may use /lh intead of /L /H);
  87.  
  88. Next I will discuss some of the PM Timer menu options you'll find in the main
  89. window's system menu.
  90.  
  91.  
  92. Settings...
  93. ===========
  94. This will bring up the settings notebook which is pretty much self explanatory
  95. and has 'fly-over-help' all over the place.
  96. Just make sure that - on the hardware settings page - you select the comport
  97. where your modem can be found and specify an accurate value in the seconds-
  98. to-carrier field. (That's the number of seconds between the time you actually
  99. connect and the time that the program detects a carrier.)
  100. Also on the general page you have to indicate if you're going to be using a
  101. Dutch or "Other" telephone costs calculation scheme. This may seem somewhat odd
  102. because the "Other" scheme could be used in stead of the Dutch scheme.
  103. The reason for the special Dutch scheme being in there is that the initial
  104. release of PM Timer (v.0.90) was Dutch-only and I didn't feel like taking the
  105. existing code out.
  106. Having this said, I guess it will be clear that you only have to fill out the
  107. costs-settings page(s) of the scheme you selected on the first page.
  108. The already filled in defaults (Including the "Other" pages) are settings for
  109. the Dutch telecom costs system. So if you live in Holland, it won't make a
  110. difference if you select Dutch or Other on the general settings page.
  111. If your not from Holland, these default settings and the fly-over help should
  112. get you started adjusting the values for your area.
  113.  
  114. Calculate...
  115. ============
  116. The calculation dialog is also very much self self explanatory. Fill in a
  117. start  and end date for the period over which you want to calculate your phone
  118. costs. The Costs field will be update on the fly as you adjust the spinbuttons.
  119. The defaults for both from and to date fields are the current date, just press
  120. Calc and your phone costs for today will be calculated.
  121. Calculation is done by reading values directly from the ASCII logfile created
  122. by PM Timer. So I would not advice you to manually edit that file, unless you
  123. really know what you're doing. Results could be unpredictable if the program
  124. finds stuff in the logfile that doesn't belong there.
  125.  
  126. NOTE: The currency symbol in the costs field and the date fields are country
  127.       dependant. So if you don't see the costs displayed in your own currency
  128.       it's because you're COUNTRY= line in config.sys doesn't reflect the
  129.       country you live in.
  130.  
  131.  
  132. Log window
  133. ==========
  134. This is just there for your convenience. It displays the logfile in a separate
  135. scrollable window.
  136.  
  137.  
  138. Product information
  139. ===================
  140. Displays a dialog with some program info and how to contact me. Please feel
  141. free to click a round a bit in this dialog. :)
  142.  
  143.  
  144. Note about the timer-display
  145. ============================
  146. Sometimes it may seem as if the timer skips a second. This is normal behaviour.
  147. PM Timer internaly uses the hardware IRQ0 timer interrupt to keep track of your
  148. online time. This way the timer always runs independent of system load.
  149. However the timer-display *update* does run on a simple OS/2 internal timer and
  150. thus is dependent on system load.
  151. The reason that PM Timer does not simply take timestamps from the system clock,
  152. is that I (and mayby you and a lot of other people) use programs that synchro-
  153. nize your PC's systemtime with an Internet timeserver while online.
  154. With the current implementation of PM Timer, this doesn't effect timings at all.
  155.  
  156.  
  157. Please send any bug reports and/or suggestions
  158. to enhance the program to the author:
  159.  
  160.            Jeffrey Habets
  161. snailmail: Generaal Eisenhowerstraat 41
  162.            6224 XH Maastricht / Netherlands
  163. e-mail:    jhabets@pi.net
  164. http:      www.pi.net/~jhabets
  165. FidoNet:   2:284/312.3
  166.  
  167. Reported bugs will be fixed as soon as possible if necessary. I can't make any
  168. promises on implementing enhancements to the program though. I also have my
  169. final exams to think about this year.
  170.  
  171. At the moment this program is released as freeware. Despite that, I would like
  172. to hear from you if you intent on using PM Timer on a regular basis. (e-mail
  173. is fine, but I also would appreciate a nice postcard of your home town. And of
  174. course I am not exactly *forbidding* you to send me any money. ;-)
  175. That way I can keep track on the number of people that use PM Timer and in
  176. what countries they live. This will help me to decide on future releases for
  177. the program.
  178.  
  179.  
  180. Copyright and Warranty
  181. ======================
  182. PM Timer/2 en all files that come with it in the archive may only be spread in
  183. unmodified form with or without the author's permission. If you decide to spread
  184. the program on a certain media (say disk or CD) you are only allowed to charge
  185. minimal fees to cover expenses.
  186. In any other case the author's written permission is needed.
  187. PM Timer comes without any kind of warranty. The only thing I can guarantee is
  188. that the program uses harddisk space, RAM and CPU-time.
  189. The author assumes no responsibility for any damage or loss of data arising
  190. from the use or inability to use this program.
  191.  
  192.